Add documentation about target.$triple.runner
authorIngvar Stepanyan <me@rreverser.com>
Wed, 26 Apr 2017 00:32:20 +0000 (01:32 +0100)
committerIngvar Stepanyan <me@rreverser.com>
Fri, 12 May 2017 22:14:11 +0000 (23:14 +0100)
src/doc/config.md

index 382b5c145297b52d6608cc5c56da357ca3f741cf..679bc5f9bc96ecb8553bf42c8a77d854ef83c1a4 100644 (file)
@@ -57,15 +57,20 @@ email = "..."
 vcs = "none"
 
 # For the following sections, $triple refers to any valid target triple, not the
-# literal string "$triple", and it will apply whenever that target triple is\r
+# literal string "$triple", and it will apply whenever that target triple is
 # being compiled to. 'cfg(...)' refers to the Rust-like `#[cfg]` syntax for
 # conditional compilation.
-[target.$triple]\r
-# This is the linker which is passed to rustc (via `-C linker=`) when the `$triple`\r
+[target.$triple]
+# This is the linker which is passed to rustc (via `-C linker=`) when the `$triple`
 # is being compiled for. By default this flag is not passed to the compiler.
-linker = ".."\r
-# Same but for the library archiver which is passed to rustc via `-C ar=`.\r
+linker = ".."
+# Same but for the library archiver which is passed to rustc via `-C ar=`.
 ar = ".."
+# If a runner is provided, compiled targets for the `$triple` will be executed
+# by invoking the specified runner executable with actual target as first argument.
+# This applies to `cargo run`, `cargo test` and `cargo bench` commands.
+# By default compiled targets are executed directly.
+runner = ".."
 # custom flags to pass to all compiler invocations that target $triple
 # this value overrides build.rustflags when both are present
 rustflags = ["..", ".."]